home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / rlog_142.zip / REMOTLOG.DOC < prev    next >
Text File  |  1992-03-22  |  23KB  |  537 lines
  1.                          R E M O T E   A C C E S S
  2.  
  3.  
  4.                   L O G  R E P O R T I N G  P R O G R A M
  5.  
  6.  
  7.                             Sep. 1990 - 1992
  8.  
  9.  
  10.                                 REMOTLOG
  11.  
  12.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  13.    /     /   /      / /   //  /     /     /      /        /     /  /
  14.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  15.    /     /   /      /      /  /     /     /      /        /     /  /     /
  16.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  17.  
  18. The Program  - Remotlog
  19.  
  20.  
  21.         I developed Remotlog because when the announcement of RA was made and I
  22.         endeavored to switch from QuickBBS.  There was something missing.  I
  23.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  24.         trying to get the implementation of my old program by its author, I
  25.         decided that it was time to do some coding.
  26.  
  27.         Here we have the finished product.  A full fledged RA log reporting
  28.         program.  This program is in no way crippled.  And never will be.
  29.  
  30.  
  31.  
  32.         RA is the registered product of Continental Software.
  33.         QuickBBS is the registered product of The QuickBBS Support Group or     
  34.         whatever it is now adays.
  35.  
  36.  
  37.         At present this program will function with RA version 1.0x.
  38.  
  39.         Do not attempt to use this program with any other software except RA
  40.         because it uses the file MESSAGES.RA, FILES.RA and several other RA     
  41.         specific files.  If it cannot find this file the
  42.         program will abort in error.
  43.  
  44.         The screens provided by this program are as the author thought you
  45.         the sysops would like to see.  If you feel the information is too much
  46.         or that there is not enough, or would even like to see some of the
  47.         information moved from one location to another part of the page or a
  48.         totaly different screen.  Please do not hesitate to let the author
  49.         know.
  50.  
  51.  
  52.  
  53.  
  54. Configuration of Remotlog
  55.  
  56.    This is exactly as it appears in the Configuration file.  If you haven't
  57.    unzipped it.  It would behove you to do so.  And use it.  RTFM is now in
  58.    effect.
  59.  
  60. ;-------------------------------------------------------------------------
  61. ;                       Remotlog Configuration file
  62. ;                        By Orland Carter 1:135/72
  63. ;-------------------------------------------------------------------------
  64. ;
  65. ;-------------------------------------------------------------------------
  66. ;               R E G I S T R A T I O N   I N F O R M A T I O N
  67. ;-------------------------------------------------------------------------
  68. ;         {______________________________}
  69. BoardName  Opa-Locka Tower
  70. ;         {____________________}
  71. SysopName  Orland Carter
  72. RegistKey  00000000000000000000
  73. ;
  74. ;-------------------------------------------------------------------------
  75. ; This is a required entry.  It tells the program the [path + filename] of
  76. ; the Log file to be processed.
  77. ; DEFAULT : SYSTEM.LOG
  78. ;-------------------------------------------------------------------------
  79. ;
  80. LogFile SYSTEM.LOG
  81. ;
  82. ;-------------------------------------------------------------------------
  83. ; This entry is not required if you are only running single line system.
  84. ; If you are running Multi-Line and want to delete or zip each lines separate
  85. ; log files then this is needed.  LINEINUSE ##.  Where ## is the line being
  86. ; processed by this configuration file.  ## range is 1..99
  87. ;-------------------------------------------------------------------------
  88. ;
  89. LineInUse 1
  90. ;
  91. ;-------------------------------------------------------------------------
  92. ; This option is required if you want REMOTLOG to process the file Xfers
  93. ; against the files counter for a good downloaded count.  The DEFAULT is
  94. ; NOFDLOGFILE  the other option is FDLOGFILE \.......\  where \..\ is the
  95. ; [Path + Filename] of the FD log file.
  96. ;-------------------------------------------------------------------------
  97. ;
  98. FDLogFile C:\Fd\Fd.Log
  99. ;
  100. ;-------------------------------------------------------------------------
  101. ; This option is required.  It tells the program what the Dos Shell entry
  102. ; of your External chat program is.  This must be the same case as the
  103. ; BBS writes it to the log file.  Required whether you have one or not.
  104. ; DEFAULT : FX-CHAT.EXE
  105. ;-------------------------------------------------------------------------
  106. ;
  107. ExternalChat FastChat.EXE
  108. ;
  109. ;-------------------------------------------------------------------------
  110. ; This option is required.  It tells the program what [path + filename]
  111. ; the output of the program should be placed in. *.asc/*.ans versions.
  112. ; DEFAULT : REMOTLOG
  113. ;-------------------------------------------------------------------------
  114. ;
  115. Outputfile c:\RA\Txt\Remotlog
  116. ;
  117. ;-------------------------------------------------------------------------
  118. ; This option is required.  It tells the program which color to place the
  119. ; background of the ansi screen in.
  120. ; DEFAULT : 40
  121. ;-------------------------------------------------------------------------
  122. ;
  123. Back 40
  124. ;
  125. ;-------------------------------------------------------------------------
  126. ; This option is required.  It tells the program what color the numbers
  127. ; displayed are.
  128. ; DEFAULT : 1;33
  129. ;-------------------------------------------------------------------------
  130. ;
  131. Numbers 1;33
  132. ;
  133. ;-------------------------------------------------------------------------
  134. ; This option is required.  It tells the program what color to use when
  135. ; highlighting the Beginning and Ending dates of the Log period.
  136. ; DEFAULT : 1;46;37
  137. ;-------------------------------------------------------------------------
  138. ;
  139. HighLight 1;46;37
  140. ;
  141. ;-------------------------------------------------------------------------
  142. ; This option is required.  It tells the program which color to use to
  143. ; restore the screen to "normal".
  144. ; DEFAULT : 0
  145. ;-------------------------------------------------------------------------
  146. ;
  147. Normal 0
  148. ;
  149. ;-------------------------------------------------------------------------
  150. ; This option is required.  It tells the program which color to use for
  151. ; Outlining the Box and Dividing lines of the output file.
  152. ; DEFAULT 1;34
  153. ;-------------------------------------------------------------------------
  154. ;
  155. Outline 1;34
  156. ;
  157. ;-------------------------------------------------------------------------
  158. ; This option is required.  It tells the program which color to use for
  159. ; all the text that is printed.
  160. ; DEFAULT 0;32
  161. ;-------------------------------------------------------------------------
  162. ;
  163. Text 0;32
  164. ;
  165. ;-------------------------------------------------------------------------
  166. ; This option is required.  It tells the program whether or not you wish
  167. ; the optional page of Multiline usage to be displayed.  The statistics
  168. ; will still be stored if the option is not selected.
  169. ; DEFAULT : NOMULTILINE
  170. ;-------------------------------------------------------------------------
  171. ;
  172. NoMultiLine
  173. ;
  174. ;-------------------------------------------------------------------------
  175. ; This option is required.  It telss the program what type of log file
  176. ; You are using.  Wether FD/COMPACT [Front Door type] or OPUS/EXPANDED.
  177. ; DEFAULT FD / COMPACT
  178. ;-------------------------------------------------------------------------
  179. ;
  180. COMPACT
  181. ;
  182. ;-------------------------------------------------------------------------
  183. ; This option is not required and at the descretion of the sysop.  Using
  184. ; This will cause another page to be displayed in addition to the current
  185. ; 2 or 3 pages that are already displayed.  This option is where the sysop
  186. ; Can have remotlog search the logfile for something specific and keep
  187. ; track of its occurrences.
  188. ; I.e. *01My_Name Carter      - This will cause remotlog to search the log
  189. ; file for all occurences of "Carter" it will accumulate and store the
  190. ; amount of time it finds it in variable 01.  When it displays it it will
  191. ; display "My_Name >>> ####" where # is amount of times the item was found
  192. ; Possible Variables are 00-29.  The 0 is significant.  The "*" is required
  193. ; There can be no spaces except to separate the Display item from the
  194. ; Search item.
  195. ; Format "*<Variable 00-29><Entry to Make in *.Ans/*.Asc file> <Search For>"
  196. ;         *00My_Name Carter
  197. ;-------------------------------------------------------------------------
  198. ;
  199. ;*00Graffitti_Wall  Grafn3.EXE
  200. ;*01JetFighter_Game Combat 1
  201. ;
  202. ;-------------------------------------------------------------------------
  203. ; These options are not required.  But they do provide you with a great
  204. ; amount of security.  For areas you do not want all your users to see.
  205. ; IE. Adult areas or Sysop areas.  (Message Areas)
  206. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  207. ;-------------------------------------------------------------------------
  208. ;
  209. NoShow  8
  210. NoShow 10
  211. NoShow 12
  212. ;
  213. ;-------------------------------------------------------------------------
  214. ; These options are not required.  But they do provide you with a great
  215. ; amount of security.  For areas you do not want all your users to see.
  216. ; IE. Adult areas or Sysop areas.  (File Areas)
  217. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  218. ;-------------------------------------------------------------------------
  219. ;
  220. NoFile  8
  221. NoFile 10
  222. NoFile 12
  223. ;
  224. ;-------------------------------------------------------------------------
  225. ; This option is not required.  It is used to Change the default Sealink
  226. ; protocol displayed in the 1st output page to a protocol of your choosing.
  227. ; REPLACESEA - Is the Search String for the new protocol.
  228. ; REPLACEDSP - Is the Actual Item to be displayed in the Output page.
  229. ;-------------------------------------------------------------------------
  230. ;
  231. ;ReplaceSea SEALink
  232. ;ReplaceDsp SEALink
  233. ;
  234. ;-------------------------------------------------------------------------
  235. ; This option is also not required.  It determines whether or not the local
  236. ; logons will be shown on the report output.  The DEFAULT for this option
  237. ; is show local logons.  Leave this option out for the default to take
  238. ; effect.
  239. ;-------------------------------------------------------------------------
  240. ;
  241. ;NoLocal
  242. ;
  243. ;-------------------------------------------------------------------------
  244. ; This option is also not required.  It activates or deactivates the
  245. ; Files.BBS downloaded files counter.  The count will be stored and added
  246. ; to the Files.BBS in the directory the file was taken from.  DEFAULT for
  247. ; This option is FILECOUNTER,     To deactivate use NOFILECOUNT
  248. ;-------------------------------------------------------------------------
  249. ;
  250. FILECOUNTER
  251. ;
  252. ;-------------------------------------------------------------------------
  253. ; This option is also not required.  It activates a chat record.  This will
  254. ; log all chats found in the log file to a file called REMOTLOG.CHT in the
  255. ; current directory.  The DEFAULT is CHATRECORD, all chats will be logged.
  256. ; The other option to disable the chat is NOCHATRECORD
  257. ; A file is created named REMOTLOG.CHT
  258. ;-------------------------------------------------------------------------
  259. ;
  260. CHATRECORD
  261. ;
  262. ;-------------------------------------------------------------------------
  263. ; This option is also not required.  It activates or Deactivates the log
  264. ; deleting option.  The DEFAULT is the log will be deleted every 10 days.
  265. ; The two options are DELETELOG ## (Where ## is days log should be kept.)
  266. ; and NODELETELOG.
  267. ;-------------------------------------------------------------------------
  268. ;
  269. DELETELOG 7
  270. ;
  271. ;-------------------------------------------------------------------------
  272. ; This option is also not required.  It activates or Deactivates the log
  273. ; deleting option for the Front End Mailer (Front Door)).  The DEFAULT is
  274. ; the fd log will be deleted with the RA log.
  275. ; The two options are DELETEFDLOG and NODELETEFDLOG.
  276. ;-------------------------------------------------------------------------
  277. ;
  278. DELETEFDLOG
  279. ;
  280. ;-------------------------------------------------------------------------
  281. ; This option is also not required.  It will determine whether or not the
  282. ; Log file actually gets deleted/zipped/shrunk and/or given an individual date
  283. ; for storage.  The zip method used is PKZIP.  any version.  The file will
  284. ; be moved while zipped.  The zipped name will be in the format RLMMDDYY.ZIP
  285. ; This option will not function if the Delete log option is disabled.
  286. ; Pkzip must be in the current directory or properly pathed.
  287. ; DEFAULT - NOZIPFILE           other otion is ZIPFILE and SHRINKFILE
  288. ;-------------------------------------------------------------------------
  289. ;
  290. SHRINKFILE
  291. ;
  292. ;-------------------------------------------------------------------------
  293. ; This tells remotlog which message area to post the statistics files
  294. ; generated to.  A value of 0 here would cause remotlog to not post the
  295. ; files to the message area.  But will still accumulate information in
  296. ; Them.  This option is REQUIRED.
  297. ;-------------------------------------------------------------------------
  298. ;
  299. MessageBoard 3
  300. ;
  301. ;-------------------------------------------------------------------------
  302. ; This option is not required and defaults to Off.  It will determine if
  303. ; Remotlog will log a copy of all BBS downloads out to a file.  This file
  304. ; will be called Remotlog.Dwn  IT will be appended to.  To activate this
  305. ; option the Keyword is DOWNLOADS
  306. ;-------------------------------------------------------------------------
  307. ;
  308. ;Downloads
  309. ;
  310. ;-------------------------------------------------------------------------
  311. ; This option is not required and defaults to off.  It determines whether
  312. ; or not REMOTLOG will log a copy of all users that access any of the
  313. ; doors that you use on your system.  It logs them all to a file called
  314. ; REMOTLOG.DRS.  It will also append if the file is not erased.  The file
  315. ; as with all others created will be posted to the message base to the
  316. ; sysop.  The word to activate this option is WHATDOORS
  317. ;-------------------------------------------------------------------------
  318. ;
  319. ;WhatDoors
  320. ;
  321. ;-------------------------------------------------------------------------
  322. ; This option is not required and defaults to off.  It determines whether
  323. ; or not REMOTLOG will log a copy of all users that access any of the
  324. ; questionaires that you have for your users.  It logs them all to a file
  325. ; called REMOTLOG.QST.  It will also append if the file is not erased. The
  326. ; file will be posted to the message base.  Option is QUESTIONAIRE
  327. ;-------------------------------------------------------------------------
  328. ;
  329. ;QUESTIONAIRE
  330. ;
  331. ;-------------------------------------------------------------------------
  332. ; This option is not required and defaults to off.  It determines wheter
  333. ; or not REMOTLOG will create separate files for each report Screen.  The
  334. ; files will be REMOTLO#.ASC/ANS.  Where # is 1 - 5 depending on the Page
  335. ; the report.  OPTION SPLITFILES.
  336. ;-------------------------------------------------------------------------
  337. ;
  338. ;SPLITFILES
  339. ;
  340. ;-------------------------------------------------------------------------
  341. ; This option is not required and default to off.  It determines whether
  342. ; or not the Files.BBS listings will be sorted.  The sort now respects non-
  343. ; Filename characters at anypoint in the file and will no longer sort them
  344. ; to the top.  OPTION:  NOSORT
  345. ;-------------------------------------------------------------------------
  346. ;
  347. ;NOSORT
  348. ;
  349. ;-------------------------------------------------------------------------
  350. ; This option is not required and defaults to off.  It determines whether
  351. ; or not Superlog will generate a message to those users that have dropped
  352. ; carrier on your system.  Filename is required and must contain at least
  353. ; one character. OPTION: DROPCARRIER <FILENAME>    , NODDROPCARRIER
  354. ;-------------------------------------------------------------------------
  355. ;
  356. DROPCARRIER DROPMESS.TXT
  357. ;
  358. ;-------------------------------------------------------------------------
  359. ; This option is not required and defaults to off.  It determines whether
  360. ; or not superlog will generate a message to those users who have uploaded
  361. ; to the system.  Filename is required to Post a message and it must at
  362. ; least contain 1 character.  Option: UPLOADMSG <filename> , NOUPLOADMSG
  363. ;-------------------------------------------------------------------------
  364. ;
  365. UPLOADMSG Upload.TXT
  366. ;
  367. ;-------------------------------------------------------------------------
  368. ; This option is not required and defaults to off.  It determines whether
  369. ; or not superlog will generate a message to those users who have just logged
  370. ; on to the system.  New Users.  Filename is required to post a message and it
  371. ; must at least contain 1 character.
  372. ; Option: NEWUSERMSG <filename>,NONEWUSERMSG
  373. ;-------------------------------------------------------------------------
  374. ;
  375. NEWUSERMSG NewUser.TXT
  376. ;
  377. ;-------------------------------------------------------------------------
  378. ; This option is not required and defaults to off.  It will let REMOTLOG
  379. ; know that you have a CDROM Drive and which one it is.  Given the differences
  380. ; between manufacturers of CDROM drives for computers and how they place
  381. ; files on them.  This option allows for easy and more simplistic handling
  382. ; of those.  OPTION: CDROM <Drive Number> <Drive Letter>\
  383. ; Where drive number is 0-9 to indicate the physical number of the CDROM
  384. ; drive.  Drive Letter is of course whatever the CDROM drive letter is.
  385. ;-------------------------------------------------------------------------
  386. ;
  387. ;CDROM 0 L:\
  388. ;CDROM 1 M:\
  389. ;CDROM 2 O:\
  390. ;
  391. ;-------------------------------------------------------------------------
  392. ;          E N D    O F    R E M O T L O G . C F G   F I L E
  393. ;-------------------------------------------------------------------------
  394.  
  395.  
  396.  
  397.  
  398.  
  399. Supplied ANSI Code sequences
  400.  
  401. Number  Represents
  402. ------  ----------
  403. 0       All attributes off  (Normal Display)
  404.  
  405. 1       High Intensity (Bold)
  406.  
  407. 5       Sets Blink on
  408.  
  409. 7       Reverse Video on
  410.  
  411. 8       Concealed on (makes display invisible)
  412.  
  413. 30      Foreground      Black
  414.  
  415. 31                      Red
  416.  
  417. 32                      Green
  418.  
  419. 33                      Yellow
  420.  
  421. 34                      Blue on Color Monitor
  422.                         Underline on MonoChrome
  423.  
  424. 35                      Magenta
  425.  
  426. 36                      Cyan
  427.  
  428. 37                      White
  429.  
  430. 40      BackGround      Black
  431.  
  432. 41                      Red
  433.  
  434. 42                      Green
  435.  
  436. 43                      Yellow
  437.  
  438. 44                      Blue
  439.  
  440. 45                      Magenta
  441. 46                      Cyan
  442.  
  443. 47                      White
  444.  
  445.  
  446.  
  447.  
  448.  
  449. Hints about operation of this program
  450.  
  451.   There are several different things that you can do to get certain results
  452.   from this program.
  453.  
  454.    For example if you want to change the beging date of the report without
  455.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  456.    find the string that has the date in it and make it a null string.  When the
  457.    program starts up it will notice the date is missing and get the date from
  458.    the current system.log file.
  459.  
  460.    When reading the log file the program will not attempt to reposition pointers
  461.    if the last item in the log is that "REMOTLOG has checked the log."  Of      
  462.      course
  463.    the current session will be appended to the end of the logfile.
  464.  
  465.    By deleting the notations that REMOTLOG makes in the log file you can force
  466.    it to re-process the log file.
  467.  
  468.    The *##^^^^^^^^^ ___ option will accept hard spaces in the search for        
  469.      portion.
  470.    It is not restricted.
  471.  
  472.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  473.    to Node 1:135/72.  or the addresses listed in the registration section.  I   
  474.      can
  475.    also be reached in the RA_UTIL echo.  Before you send me a
  476.    bug report if you are not registered and if you are.  Insure that you RTM
  477.    and read the configuration file comments before screaming bug report.  If you
  478.    send me netmail bug reports and are not registered do not wait for a netmail
  479.    reply.  It cost me money to send a net message back to you and you couldn't
  480.    find it to register.  All bug reports must contain a copy of Errors.log and
  481.    a summarized copy of your configuration file.  Meaning leave out all the     
  482.      lines
  483.    with a ";" in them.  Explain the bug in full detail.  If not I will simply
  484.    ignore it or send you a message indicating that I will take no action until
  485.    you can meet the bug report requirements.
  486.  
  487.  
  488. Credits
  489.  
  490.    The author, Orland K. Carter, would like to thank my beta testers of
  491.    this program that put up with the constant updates to the one program and
  492.    major overhaul of their configuration and data files.
  493.  
  494.    To Peter Janssens a special thank you
  495.    and John Barton, Arturo Batista, Daniel Johnston, and Robert Taylor my
  496.    thanks you for your patience, and help in beta testing this program.
  497.  
  498.  
  499. Registrations
  500.  
  501.    The cost to register REMOTLOG is whatever you feel the program is worth.
  502.    From $15 and up. Registrations will be sent to.
  503.  ________________________________________________________________________
  504. |Registration of REMOTLOG,                    Form 1.42, U.Date 22 MAR 92|
  505. |------------------------------------------------------------------------|
  506. |                                                                        |
  507. |SysopName                                                               |
  508. |Name of Sysop __________________________________________________________|
  509. |                                                                        |
  510. |Street Address__________________________________________________________|
  511. |                                                                        |
  512. |City/St/Zip   __________________________________________________________|
  513. |                                                                        |
  514. |BoardName                                                               |
  515. |Name of BBS   __________________________________________________________|
  516. |                                                                        |
  517. |Number of BBS __________________________________________________________|
  518. |                                                                        |
  519. |Node #        __________________________________________________________|
  520. |                                                                        |
  521. |Make all payments address to                                            |
  522. |  Orland K. Carter, REMOTLOG                                            |
  523. |  2850 N.W. 155 Terrace                                                 |
  524. |  Opa-Locka, FL  33054-2223                                             |
  525. |________________________________________________________________________|
  526.  
  527. Thank you for your support.
  528.  
  529.         Orland
  530. Node 1:135/72   FIDONET
  531.      55:55/2    CAPNET
  532.  
  533. Thank you for your support.
  534.  
  535.         Orland
  536.  
  537.